<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.15"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>wickr-crypto-c: wickr_dev_info Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectalign" style="padding-left: 0.5em;">
   <div id="projectname">wickr-crypto-c
   </div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.15 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
  initMenu('',true,false,'search.php','Search');
  $(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

</div><!-- top -->
<div class="header">
  <div class="summary">
<a href="#pub-attribs">Data Fields</a>  </div>
  <div class="headertitle">
<div class="title">wickr_dev_info Struct Reference<div class="ingroups"><a class="el" href="group__wickr__dev__info.html">Wickr_dev_info</a></div></div>  </div>
</div><!--header-->
<div class="contents">

<p>Device Information used to make a uniquely identifying set of data for each context running the Wickr Protocol.  
 <a href="structwickr__dev__info.html#details">More...</a></p>

<p><code>#include &lt;<a class="el" href="devinfo_8h_source.html">devinfo.h</a>&gt;</code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr class="memitem:a78032877515c2b4cf67c48e4eb6fb0f7"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structwickr__buffer.html">wickr_buffer_t</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structwickr__dev__info.html#a78032877515c2b4cf67c48e4eb6fb0f7">dev_salt</a></td></tr>
<tr class="separator:a78032877515c2b4cf67c48e4eb6fb0f7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a084d0cd9e73d9f74f62c9e9abb85436f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structwickr__buffer.html">wickr_buffer_t</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structwickr__dev__info.html#a084d0cd9e73d9f74f62c9e9abb85436f">system_salt</a></td></tr>
<tr class="separator:a084d0cd9e73d9f74f62c9e9abb85436f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a864ad03c4d10f51fe6251059007276d2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structwickr__buffer.html">wickr_buffer_t</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structwickr__dev__info.html#a864ad03c4d10f51fe6251059007276d2">msg_proto_id</a></td></tr>
<tr class="separator:a864ad03c4d10f51fe6251059007276d2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af5f2ff06ae74fcec85106f6ffd77c008"><td class="memItemLeft" align="right" valign="top"><a class="el" href="structwickr__buffer.html">wickr_buffer_t</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structwickr__dev__info.html#af5f2ff06ae74fcec85106f6ffd77c008">srv_comm_id</a></td></tr>
<tr class="separator:af5f2ff06ae74fcec85106f6ffd77c008"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Device Information used to make a uniquely identifying set of data for each context running the Wickr Protocol. </p>
<p>These identifiers are not required to be absolutely unique from a security perspective, but having a good amount of entropy in them is a nice property to attempt to achieve. </p>
</div><h2 class="groupheader">Field Documentation</h2>
<a id="a78032877515c2b4cf67c48e4eb6fb0f7"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a78032877515c2b4cf67c48e4eb6fb0f7">&#9670;&nbsp;</a></span>dev_salt</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">wickr_dev_info::dev_salt</td>
        </tr>
      </table>
</div><div class="memdoc">
<p>a random salt used in generating 'msg_proto_id' and 'srv_comm_id'. Ideally, this salt value is generated and stored on the device in a way it is quickly retrived. It does not need to be transmitted off the device, as it simply provides some entropy to Wickr specific identifier generation. </p>

</div>
</div>
<a id="a864ad03c4d10f51fe6251059007276d2"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a864ad03c4d10f51fe6251059007276d2">&#9670;&nbsp;</a></span>msg_proto_id</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">wickr_dev_info::msg_proto_id</td>
        </tr>
      </table>
</div><div class="memdoc">
<p>messaging protocol identifier shared with devices transmitting data to you. Used as context within key exchanges where a context using the associated 'dev_salt' and 'system_salt' is the recipient </p>

</div>
</div>
<a id="af5f2ff06ae74fcec85106f6ffd77c008"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af5f2ff06ae74fcec85106f6ffd77c008">&#9670;&nbsp;</a></span>srv_comm_id</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">wickr_dev_info::srv_comm_id</td>
        </tr>
      </table>
</div><div class="memdoc">
<p>server communication identifier transmitted to the server and used for salting operations outside of the messaging component of Wickr, such as communicating with the Wickr Server API. </p>

</div>
</div>
<a id="a084d0cd9e73d9f74f62c9e9abb85436f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a084d0cd9e73d9f74f62c9e9abb85436f">&#9670;&nbsp;</a></span>system_salt</h2>

<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">wickr_dev_info::system_salt</td>
        </tr>
      </table>
</div><div class="memdoc">
<p>a salt that is optimally bound to a hardware context of the device the library is executing on. On systems where getting hardware specific values are not available, this salt can also be randomly generated and stored on the device. The system salt is used to salt your device storage key, and thus binding to a hardware value that is not recorded on disk could increase security of your local storage in some scenarios. </p>

</div>
</div>
<hr/>The documentation for this struct was generated from the following file:<ul>
<li>src/wickrcrypto/include/wickrcrypto/<a class="el" href="devinfo_8h_source.html">devinfo.h</a></li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.15
</small></address>
</body>
</html>
